home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-bgp-mibv4-01.txt < prev    next >
Text File  |  1993-03-03  |  34KB  |  1,006 lines
  1.  
  2. Network Working Group                                        S. Willis
  3. INTERNET DRAFT                                              J. Burruss
  4.                                          Wellfleet Communications Inc.
  5.                                                                 J. Chu
  6.                                                               IBM Corp
  7.                                                          December 1992
  8.  
  9.  
  10.                      Definitions of Managed Objects
  11.               for the Border Gateway Protocol (Version 4)
  12.  
  13.  
  14. Status of this Memo
  15.  
  16.    This memo is an extension to the SNMP MIB.  It specifies an IAB
  17.    standards track protocol for the Internet community, and requests
  18.    discussion and suggestions for improvements.  The origin of this memo
  19.    is from RFC 1269 "Definitions of Managed Objects for the Board
  20.    Gateway Protocol (Version 3)" written by the first two authors of
  21.    this memo.  Distribution of this memo is unlimited.
  22.  
  23.  
  24. 1.  Abstract
  25.  
  26.    This memo defines a portion of the Management Information Base (MIB)
  27.    for use with network management protocols in TCP/IP-based internets.
  28.    In particular, it defines objects for managing the Border Gateway
  29.    Protocol [11,12].
  30.  
  31.  
  32. 2.  The Network Management Framework
  33.  
  34.    The Internet-standard Network Management Framework consists of three
  35.    components.  They are:
  36.  
  37.       RFC 1155 which defines the SMI, the mechanisms used for describing
  38.       and naming objects for the purpose of management.  RFC 1212
  39.       defines a more concise description mechanism, which is wholly
  40.       consistent with the SMI.
  41.  
  42.       RFC 1156 which defines MIB-I, the core set of managed objects for
  43.       the Internet suite of protocols.  RFC 1213, defines MIB-II, an
  44.       evolution of MIB-I based on implementation experience and new
  45.       operational requirements.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52. Expiration Date June 1993                                       [Page 1]
  53.  
  54.                            - 2 -
  55.  
  56.  
  57.  
  58.       RFC 1157 which defines the SNMP, the protocol used for network
  59.       access to managed objects.
  60.  
  61.    The Framework permits new objects to be defined for the purpose of
  62.    experimentation and evaluation.
  63.  
  64.  
  65. 3.  Objects
  66.  
  67.    Managed objects are accessed via a virtual information store, termed
  68.    the Management Information Base or MIB.  Objects in the MIB are
  69.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  70.    defined in the SMI.  In particular, each object has a name, a syntax,
  71.    and an encoding.  The name is an object identifier, an
  72.    administratively assigned name, which specifies an object type.  The
  73.    object type together with an object instance serves to uniquely
  74.    identify a specific instantiation of the object.  For human
  75.    convenience, we often use a textual string, termed the OBJECT
  76.    DESCRIPTOR, to also refer to the object type.
  77.  
  78.    The syntax of an object type defines the abstract data structure
  79.    corresponding to that object type.  The ASN.1 language is used for
  80.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  81.    constructs which may be used.  These restrictions are explicitly made
  82.    for simplicity.
  83.  
  84.    The encoding of an object type is simply how that object type is
  85.    represented using the object type's syntax.  Implicitly tied to the
  86.    notion of an object type's syntax and encoding is how the object type
  87.    is represented when being transmitted on the network.
  88.  
  89.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  90.    subject to the additional requirements imposed by the SNMP.
  91.  
  92.  
  93. 3.1.  Format of Definitions
  94.  
  95.    Section 5 contains contains the specification of all object types
  96.    contained in this MIB module.  The object types are defined using the
  97.    conventions defined in the SMI, as amended by the extensions
  98.    specified in [9,10].
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108. Expiration Date June 1993                                       [Page 2]
  109.  
  110.                            - 3 -
  111.  
  112.  
  113.  
  114. 4.  Overview
  115.  
  116.    These objects are used to control and manage a BGP [11,12]
  117.    implementation.
  118.  
  119.    The Border Gateway Protocol (BGP) is an inter-Autonomous System
  120.    routing protocol.  The primary function of a BGP speaking system is
  121.    to exchange network reachability information with other BGP systems.
  122.    This network reachability information includes information on the
  123.    full path of Autonomous Systems that traffic must transit to reach
  124.    these networks.
  125.  
  126.    BGP runs over a reliable transport protocol.  This eliminates the
  127.    need to implement explicit update fragmentation, retransmission,
  128.    acknowledgement, and sequencing.  Any authentication scheme used by
  129.    the transport protocol may be used in addition to BGP's own
  130.    authentication mechanisms.
  131.  
  132.    The planned use of BGP in the Internet environment, including such
  133.    issues as topology, the interaction between BGP and IGPs, and the
  134.    enforcement of routing policy rules is presented in a companion
  135.    document [12].
  136.  
  137.    Apart from a few system variables, this MIB is broken into two
  138.    tables: the BGP Peer Table and the BGP Received Path Attribute Table.
  139.    The Peer Table reflects information about BGP peer connections, such
  140.    as their state and current activity.  The Received Path Attribute
  141.    Table contains all attributes received from all peers before local
  142.    routing policy has been applied.  The actual attributes used in
  143.    determining a route are a subset of the received attribute table.
  144.  
  145.  
  146. 5.  Definitions
  147.  
  148.                RFCxxxx-MIB DEFINITIONS ::= BEGIN
  149.  
  150.                IMPORTS
  151.                     NetworkAddress, IpAddress, Counter
  152.                          FROM RFC1155-SMI
  153.                     mib-2
  154.                          FROM RFC1213-MIB
  155.                   OBJECT-TYPE
  156.                          FROM RFC-1212
  157.                     TRAP-TYPE
  158.                          FROM RFC-1215;
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Expiration Date June 1993                                       [Page 3]
  165.  
  166.                            - 4 -
  167.  
  168.  
  169.  
  170.  
  171.                -- This MIB module uses the extended OBJECT-TYPE macro as
  172.                -- defined in [9], and the TRAP-TYPE macro as defined
  173.                -- in [10].
  174.  
  175.                bgp     OBJECT IDENTIFIER ::= { mib-2 15 }
  176.  
  177.  
  178.                bgpVersion OBJECT-TYPE
  179.                     SYNTAX OCTET STRING
  180.                     ACCESS read-only
  181.                     STATUS mandatory
  182.                     DESCRIPTION
  183.                          "Vector of supported BGP protocol version
  184.                          numbers. Each peer negotiates the version from
  185.                          this vector.  Versions are identified via the
  186.                          string of bits contained within this object.
  187.                          The first octet contains bits 0 to 7, the
  188.                          second octet contains bits 8 to 15, and so on,
  189.                          with the most significant bit referring to the
  190.                          lowest bit number in the octet (e.g., the MSB
  191.                          of the first octet refers to bit 0).  If a bit,
  192.                          i, is present and set, then the version (i+1)
  193.                          of the BGP is supported."
  194.                     ::= { bgp 1 }
  195.  
  196.                bgpLocalAs OBJECT-TYPE
  197.                     SYNTAX INTEGER (0..65535)
  198.                     ACCESS read-only
  199.                     STATUS mandatory
  200.                     DESCRIPTION
  201.                          "The local autonomous system number."
  202.                     ::= { bgp 2 }
  203.  
  204.                bgpPeerTable OBJECT-TYPE
  205.                     SYNTAX SEQUENCE OF BgpPeerEntry
  206.                     ACCESS not-accessible
  207.                     STATUS mandatory
  208.                     DESCRIPTION
  209.                          "The bgp peer table."
  210.                     ::= { bgp 3 }
  211.  
  212.                bgpIdentifier OBJECT-TYPE
  213.                     SYNTAX IpAddress
  214.                     ACCESS read-only
  215.  
  216.  
  217.  
  218.  
  219.  
  220. Expiration Date June 1993                                       [Page 4]
  221.  
  222.                            - 5 -
  223.  
  224.  
  225.  
  226.                     STATUS mandatory
  227.                     DESCRIPTION
  228.                          "The BGP Identifier of local system."
  229.                     ::= { bgp 4 }
  230.  
  231.                bgpPeerEntry OBJECT-TYPE
  232.                     SYNTAX BgpPeerEntry
  233.                     ACCESS not-accessible
  234.                     STATUS mandatory
  235.                     DESCRIPTION
  236.                          "Information about a BGP peer connection."
  237.                     INDEX
  238.                          { bgpPeerRemoteAddr }
  239.                         ::= { bgpPeerTable 1 }
  240.  
  241.                BgpPeerEntry ::= SEQUENCE {
  242.                     bgpPeerIdentifier
  243.                          IpAddress,
  244.                     bgpPeerState
  245.                          INTEGER,
  246.                     bgpPeerAdminStatus
  247.                          INTEGER,
  248.                     bgpPeerNegotiatedVersion
  249.                          INTEGER,
  250.                     bgpPeerLocalAddr
  251.                          IpAddress,
  252.                     bgpPeerLocalPort
  253.                          INTEGER,
  254.                     bgpPeerRemoteAddr
  255.                          IpAddress,
  256.                     bgpPeerRemotePort
  257.                          INTEGER,
  258.                     bgpPeerRemoteAs
  259.                          INTEGER,
  260.                     bgpPeerInUpdates
  261.                          Counter,
  262.                     bgpPeerOutUpdates
  263.                          Counter,
  264.                     bgpPeerInTotalMessages
  265.                          Counter,
  266.                     bgpPeerOutTotalMessages
  267.                          Counter,
  268.                     bgpPeerLastError
  269.                          OCTET STRING,
  270.                     bgpPeerFsmEstablishedTransitions
  271.  
  272.  
  273.  
  274.  
  275.  
  276. Expiration Date June 1993                                       [Page 5]
  277.  
  278.                            - 6 -
  279.  
  280.  
  281.  
  282.                          Counter
  283.                     }
  284.  
  285.                bgpPeerIdentifier OBJECT-TYPE
  286.                     SYNTAX IpAddress
  287.                     ACCESS read-only
  288.                     STATUS mandatory
  289.                     DESCRIPTION
  290.                          "The BGP Identifier of this entry's BGP peer."
  291.                     ::= { bgpPeerEntry 1 }
  292.  
  293.                bgpPeerState OBJECT-TYPE
  294.                     SYNTAX INTEGER {
  295.                          idle(1),
  296.                          connect(2),
  297.                          active(3),
  298.                          opensent(4),
  299.                          openconfirm(5),
  300.                          established(6)
  301.                     }
  302.                     ACCESS read-only
  303.                     STATUS mandatory
  304.                     DESCRIPTION
  305.                          "The bgp peer connection state. "
  306.                     ::= { bgpPeerEntry 2 }
  307.  
  308.                bgpPeerAdminStatus OBJECT-TYPE
  309.                     SYNTAX INTEGER {
  310.                          stop(1),
  311.                          start(2)
  312.                     }
  313.                     ACCESS read-write
  314.                     STATUS mandatory
  315.                     DESCRIPTION
  316.                          "The desired state of the BGP connection. A
  317.                          transition from 'stop' to 'start' will cause
  318.                          the BGP Start Event to be generated. A
  319.                          transition from 'start' to 'stop' will cause
  320.                          the BGP Stop Event to be generated. This
  321.                          parameter can be used to restart BGP peer
  322.                          connections.  Care should be used in providing
  323.                          write access to this object without adequate
  324.                          authentication."
  325.                     ::= { bgpPeerEntry 3 }
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. Expiration Date June 1993                                       [Page 6]
  333.  
  334.                            - 7 -
  335.  
  336.  
  337.  
  338.                bgpPeerNegotiatedVersion OBJECT-TYPE
  339.                     SYNTAX INTEGER
  340.                     ACCESS read-only
  341.                     STATUS mandatory
  342.                     DESCRIPTION
  343.                          "The negotiated version of BGP running between
  344.                          the two peers. "
  345.                     ::= { bgpPeerEntry 4 }
  346.  
  347.                bgpPeerLocalAddr OBJECT-TYPE
  348.                     SYNTAX IpAddress
  349.                     ACCESS read-only
  350.                     STATUS mandatory
  351.                     DESCRIPTION
  352.                          "The local IP address of this entry's BGP
  353.                          connection."
  354.                     ::= { bgpPeerEntry 5 }
  355.  
  356.                bgpPeerLocalPort OBJECT-TYPE
  357.                     SYNTAX INTEGER (0..65535)
  358.                     ACCESS read-only
  359.                     STATUS mandatory
  360.                     DESCRIPTION
  361.                          "The local port for the TCP connection between
  362.                          the BGP peers."
  363.                     ::= { bgpPeerEntry 6 }
  364.  
  365.                bgpPeerRemoteAddr OBJECT-TYPE
  366.                     SYNTAX IpAddress
  367.                     ACCESS read-only
  368.                     STATUS mandatory
  369.                     DESCRIPTION
  370.                          "The remote IP address of this entry's BGP
  371.                          peer."
  372.                     ::= { bgpPeerEntry 7 }
  373.  
  374.                bgpPeerRemotePort OBJECT-TYPE
  375.                     SYNTAX INTEGER (0..65535)
  376.                     ACCESS read-only
  377.                     STATUS mandatory
  378.                     DESCRIPTION
  379.                          "The remote port for the TCP connection between
  380.                          the BGP peers.  Note that the objects
  381.                          bgpLocalAddr, bgpLocalPort, bgpRemoteAddr and
  382.                          bgpRemotePort provide the appropriate reference
  383.  
  384.  
  385.  
  386.  
  387.  
  388. Expiration Date June 1993                                       [Page 7]
  389.  
  390.                            - 8 -
  391.  
  392.  
  393.  
  394.                          to the standard MIB TCP connection table."
  395.                     ::= { bgpPeerEntry 8 }
  396.  
  397.                bgpPeerRemoteAs OBJECT-TYPE
  398.                     SYNTAX INTEGER (0..65535)
  399.                     ACCESS read-only
  400.                     STATUS mandatory
  401.                     DESCRIPTION
  402.                          "The remote autonomous system number."
  403.                     ::= { bgpPeerEntry 9 }
  404.  
  405.                bgpPeerInUpdates OBJECT-TYPE
  406.                     SYNTAX Counter
  407.                     ACCESS read-only
  408.                     STATUS mandatory
  409.                     DESCRIPTION
  410.                          "The number of BGP UPDATE messages received on
  411.                          this connection. This object should be
  412.                          initialized to zero when the connection is
  413.                          established."
  414.                     ::= { bgpPeerEntry 10 }
  415.  
  416.                bgpPeerOutUpdates OBJECT-TYPE
  417.                     SYNTAX Counter
  418.                     ACCESS read-only
  419.                     STATUS mandatory
  420.                     DESCRIPTION
  421.                          "The number of BGP UPDATE messages received on
  422.                          this connection. This object should be
  423.                          initialized to zero when the connection is
  424.                          established."
  425.                     ::= { bgpPeerEntry 11}
  426.  
  427.                bgpPeerInTotalMessages OBJECT-TYPE
  428.                     SYNTAX Counter
  429.                     ACCESS read-only
  430.                     STATUS mandatory
  431.                     DESCRIPTION
  432.                          "The total number of messages received from the
  433.                          remote peer on this connection. This object
  434.                          should be initialized to zero when the
  435.                          connection is established."
  436.                     ::= { bgpPeerEntry 12 }
  437.  
  438.                bgpPeerOutTotalMessages OBJECT-TYPE
  439.  
  440.  
  441.  
  442.  
  443.  
  444. Expiration Date June 1993                                       [Page 8]
  445.  
  446.                            - 9 -
  447.  
  448.  
  449.  
  450.                     SYNTAX Counter
  451.                     ACCESS read-only
  452.                     STATUS mandatory
  453.                     DESCRIPTION
  454.                          "The total number of messages transmitted to
  455.                          the remote peer on this connection. This object
  456.                          should be initialized to zero when the
  457.                          connection is established."
  458.                     ::= { bgpPeerEntry 13 }
  459.  
  460.                bgpPeerLastError OBJECT-TYPE
  461.                     SYNTAX OCTET STRING (SIZE (2))
  462.                     ACCESS read-only
  463.                     STATUS mandatory
  464.                     DESCRIPTION
  465.                          "The last error code and subcode seen by this
  466.                          peer on this connection. If no error has
  467.                          occurred, this field is zero. Otherwise, the
  468.                          first byte of this two byte OCTET STRING
  469.                          contains the error code; the second contains
  470.                          the subcode."
  471.                     ::= { bgpPeerEntry 14 }
  472.  
  473.                bgpPeerFsmEstablishedTransitions OBJECT-TYPE
  474.                     SYNTAX Counter
  475.                     ACCESS read-only
  476.                     STATUS mandatory
  477.                     DESCRIPTION
  478.                          "The total number of times the BGP FSM
  479.                           transitioned intto the established state."
  480.                     ::= { bgpPeerEntry 15 }
  481.  
  482.  
  483.  
  484.                bgpRcvdPathAttrTable OBJECT-TYPE
  485.                     SYNTAX SEQUENCE OF BgpPathAttrEntry
  486.                     ACCESS not-accessible
  487.                     STATUS mandatory
  488.                     DESCRIPTION
  489.                          "The BGP Received Path Attribute Table contains
  490.                          information about paths to destination networks
  491.                          received by all peers running BGP version 3 or
  492.                          less."
  493.                     ::= { bgp 5 }
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500. Expiration Date June 1993                                       [Page 9]
  501.  
  502.                            - 10 -
  503.  
  504.  
  505.  
  506.                bgpPathAttrEntry OBJECT-TYPE
  507.                     SYNTAX BgpPathAttrEntry
  508.                     ACCESS not-accessible
  509.                     STATUS mandatory
  510.                     DESCRIPTION
  511.                          "Information about a path to a network."
  512.                     INDEX
  513.                          { bgpPathAttrDestNetwork,
  514.                            bgpPathAttrPeer }
  515.                     ::= { bgpRcvdPathAttrTable 1 }
  516.  
  517.                BgpPathAttrEntry ::= SEQUENCE {
  518.                     bgpPathAttrPeer
  519.                          IpAddress,
  520.                     bgpPathAttrDestNetwork
  521.                          IpAddress,
  522.                     bgpPathAttrOrigin
  523.                          INTEGER,
  524.                     bgpPathAttrASPath
  525.                          OCTET STRING,
  526.                     bgpPathAttrNextHop
  527.                          IpAddress,
  528.                     bgpPathAttrInterASMetric
  529.                          INTEGER
  530.                     }
  531.  
  532.                bgpPathAttrPeer OBJECT-TYPE
  533.                     SYNTAX IpAddress
  534.                     ACCESS read-only
  535.                     STATUS mandatory
  536.                     DESCRIPTION
  537.                          "The IP address of the peer where the path
  538.                          information
  539.                           was learned."
  540.                     ::= { bgpPathAttrEntry 1 }
  541.  
  542.                bgpPathAttrDestNetwork OBJECT-TYPE
  543.                     SYNTAX IpAddress
  544.                     ACCESS read-only
  545.                     STATUS mandatory
  546.                     DESCRIPTION
  547.                          "The address of the destination network."
  548.                     ::= { bgpPathAttrEntry 2 }
  549.  
  550.                bgpPathAttrOrigin OBJECT-TYPE
  551.  
  552.  
  553.  
  554.  
  555.  
  556. Expiration Date June 1993                                      [Page 10]
  557.  
  558.                            - 11 -
  559.  
  560.  
  561.  
  562.                     SYNTAX INTEGER {
  563.                          igp(1),-- networks are interior
  564.                          egp(2),-- networks learned via EGP
  565.                          incomplete(3) -- undetermined
  566.                     }
  567.                     ACCESS read-only
  568.                     STATUS mandatory
  569.                     DESCRIPTION
  570.                          "The ultimate origin of the path information."
  571.                     ::= { bgpPathAttrEntry 3 }
  572.  
  573.                bgpPathAttrASPath OBJECT-TYPE
  574.                     SYNTAX OCTET STRING
  575.                     ACCESS read-only
  576.                     STATUS mandatory
  577.                     DESCRIPTION
  578.                          "The set of ASs that must be traversed to reach
  579.                          the network. ( This object is probably best
  580.                          represented as SEQUENCE OF INTEGER. For SMI
  581.                          compatibility, though, it is represented as
  582.                          OCTET STRING. Each AS is represented as a pair
  583.                          of octets according to the following algorithm:
  584.  
  585.                               first-byte-of-pair = ASNumber / 256;
  586.                               second-byte-of-pair = ASNumber & 255;"
  587.                     ::= { bgpPathAttrEntry 4 }
  588.  
  589.                bgpPathAttrNextHop OBJECT-TYPE
  590.                     SYNTAX IpAddress
  591.                     ACCESS read-only
  592.                     STATUS mandatory
  593.                     DESCRIPTION
  594.                          "The address of the border router that should
  595.                          be used for the destination network."
  596.                     ::= { bgpPathAttrEntry 5 }
  597.  
  598.                bgpPathAttrInterASMetric OBJECT-TYPE
  599.                     SYNTAX IpAddress
  600.                     ACCESS read-only
  601.                     STATUS mandatory
  602.                     DESCRIPTION
  603.                          "The optional inter-AS metric. If this
  604.                          attribute has not been provided for this route,
  605.                          the value for this object is 0."
  606.                     ::= { bgpPathAttrEntry 6 }
  607.  
  608.  
  609.  
  610.  
  611.  
  612. Expiration Date June 1993                                      [Page 11]
  613.  
  614.                            - 12 -
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.                bgp4RcvdPathAttrTable OBJECT-TYPE
  622.                     SYNTAX SEQUENCE OF Bgp4PathAttrEntry
  623.                     ACCESS not-accessible
  624.                     STATUS mandatory
  625.                     DESCRIPTION
  626.                          "The BGP-4 Received Path Attribute Table contains
  627.                          information about paths to destination networks
  628.                          received by all BGP4 peers."
  629.                     ::= { bgp 6 }
  630.  
  631.                bgp4PathAttrEntry OBJECT-TYPE
  632.                     SYNTAX Bgp4PathAttrEntry
  633.                     ACCESS not-accessible
  634.                     STATUS mandatory
  635.                     DESCRIPTION
  636.                          "Information about a path to a network."
  637.                     INDEX
  638.                          { bgp4PathAttrPeer,
  639.                            bgp4PathAttrIpAddrPrefixLen,
  640.                            bgp4PathAttrIpAddrPrefix }
  641.                     ::= { bgp4RcvdPathAttrTable 1 }
  642.  
  643.                Bgp4PathAttrEntry ::= SEQUENCE {
  644.                     bgp4PathAttrPeer
  645.                          IpAddress,
  646.                     bgp4PathAttrIpAddrPrefixLen
  647.                          INTEGER,
  648.                     bgp4PathAttrIpAddrPrefix
  649.                          OCTET STRING,
  650.                     bgp4PathAttrOrigin
  651.                          INTEGER,
  652.                     bgp4PathAttrASPathSegment
  653.                          OCTET STRING,
  654.                     bgp4PathAttrNextHop
  655.                          IpAddress,
  656.                     bgp4PathAttrMultiExitDisc
  657.                          INTEGER,
  658.                     bgp4PathAttrLocalPref
  659.                          INTEGER,
  660.                     bgp4PathAttrAtomicAggregate
  661.                          INTEGER,
  662.                     bgp4PathAttrAggregator
  663.  
  664.  
  665.  
  666.  
  667.  
  668. Expiration Date June 1993                                      [Page 12]
  669.  
  670.                            - 13 -
  671.  
  672.  
  673.  
  674.                          INTEGER
  675.                     }
  676.  
  677.                bgp4PathAttrPeer OBJECT-TYPE
  678.                     SYNTAX IpAddress
  679.                     ACCESS read-only
  680.                     STATUS mandatory
  681.                     DESCRIPTION
  682.                          "The IP address of the peer where the path
  683.                          information was learned."
  684.                     ::= { bgp4PathAttrEntry 1 }
  685.  
  686.                bgp4PathAttrIpAddrPrefixLen OBJECT-TYPE
  687.                     SYNTAX INTEGER (0..255)
  688.                     ACCESS read-only
  689.                     STATUS mandatory
  690.                     DESCRIPTION
  691.                          "Length in bits of the IP address prefix in the
  692.                           Network Layer Reachability Information field."
  693.                     ::= { bgp4PathAttrEntry 2 }
  694.  
  695.                bgp4PathAttrIpAddrPrefix OBJECT-TYPE
  696.                     SYNTAX OCTET STRING
  697.                     ACCESS read-only
  698.                     STATUS mandatory
  699.                     DESCRIPTION
  700.                          "An IP address prefix in the Network Layer
  701.                           Reachability Information field.  This string
  702.                           contains as many octets as necessary to hold
  703.                           a prefix of the length specified by
  704.                           bgp4PathAttrIpAddrPrefixLen.  Any bits
  705.                           beyond the length specified by
  706.                           bgp4PathAttrIpAddrPrefixLen are zeroed."
  707.                     ::= { bgp4PathAttrEntry 3 }
  708.  
  709.                bgp4PathAttrOrigin OBJECT-TYPE
  710.                     SYNTAX INTEGER {
  711.                          igp(1),-- networks are interior
  712.                          egp(2),-- networks learned via EGP
  713.                          incomplete(3) -- undetermined
  714.                     }
  715.                     ACCESS read-only
  716.                     STATUS mandatory
  717.                     DESCRIPTION
  718.                          "The ultimate origin of the path
  719.  
  720.  
  721.  
  722.  
  723.  
  724. Expiration Date June 1993                                      [Page 13]
  725.  
  726.                            - 14 -
  727.  
  728.  
  729.  
  730.                           information."
  731.                     ::= { bgp4PathAttrEntry 4 }
  732.  
  733.                bgp4PathAttrASPathSegment OBJECT-TYPE
  734.                     SYNTAX OCTET STRING
  735.                     ACCESS read-only
  736.                     STATUS mandatory
  737.                     DESCRIPTION
  738.                          "The sequence of AS path segments. Each AS
  739.                           path segment is represented by a triple
  740.                          <type, length, value>.
  741.  
  742.                          The type is a 1-octet field which has two
  743.                          possible values:
  744.                               1      AS_SET: unordered set of ASs a
  745.                                           route in the UPDATE message
  746.                                           has traversed
  747.                               2      AS_SEQUENCE: ordered set of ASs
  748.                                           a route in the UPDATE message
  749.                                           has traversed.
  750.  
  751.                           The length is a 1-octet field containing the
  752.                           number of ASs in the value field.
  753.  
  754.                           The value field contains one or more AS
  755.                           numbers, each AS is represented in the octet
  756.                           string as a pair of octets according to the
  757.                           following algorithm:
  758.  
  759.                                first-byte-of-pair = ASNumber / 256;
  760.                                second-byte-of-pair = ASNumber & 255;"
  761.                     ::= { bgp4PathAttrEntry 5 }
  762.  
  763.                bgp4PathAttrNextHop OBJECT-TYPE
  764.                     SYNTAX IpAddress
  765.                     ACCESS read-only
  766.                     STATUS mandatory
  767.                     DESCRIPTION
  768.                          "The address of the border router that should
  769.                          be used for the destination network."
  770.                     ::= { bgp4PathAttrEntry 6 }
  771.  
  772.                 bgp4PathAttrMultiExitDisc OBJECT-TYPE
  773.                     SYNTAX INTEGER (0..255)
  774.                     ACCESS read-only
  775.  
  776.  
  777.  
  778.  
  779.  
  780. Expiration Date June 1993                                      [Page 14]
  781.  
  782.                            - 15 -
  783.  
  784.  
  785.  
  786.                     STATUS mandatory
  787.                     DESCRIPTION
  788.                          "This metric is used to discriminate between
  789.                           multiple exit points to an adjacent autonomous
  790.                           system."
  791.                     ::= { bgp4PathAttrEntry 7 }
  792.  
  793.                bgp4PathAttrLocalPref OBJECT-TYPE
  794.                     SYNTAX INTEGER (0..255)
  795.                     ACCESS read-only
  796.                     STATUS mandatory
  797.                     DESCRIPTION
  798.                          "The originating BGP4 speaker's degree of
  799.                           preference for an advertised route."
  800.                     ::= { bgp4PathAttrEntry 8 }
  801.  
  802.                bgp4PathAttrAtomicAggregate OBJECT-TYPE
  803.                     SYNTAX INTEGER {
  804.                          less-specific-route-not-selected(1),
  805.                          less-specific-route-selected(2)
  806.                     }
  807.                     ACCESS read-only
  808.                     STATUS mandatory
  809.                     DESCRIPTION
  810.                          "Whether or not the local system has selected
  811.                           a less specific route without selecting a
  812.                           more specific route."
  813.                     ::= { bgp4PathAttrEntry 9 }
  814.  
  815.                bgp4PathAttrAggregator OBJECT-TYPE
  816.                     SYNTAX INTEGER (0..65535)
  817.                     ACCESS read-only
  818.                     STATUS mandatory
  819.                     DESCRIPTION
  820.                         "The AS number of the last BGP4 speaker that
  821.                          performed route aggregation. "
  822.                     ::= { bgp4PathAttrEntry 10 }
  823.  
  824.  
  825.  
  826.                bgpEstablished TRAP-TYPE
  827.                     ENTERPRISE { bgp }
  828.                     VARIABLES  { bgpPeerRemoteAddr,
  829.                               bgpPeerLastError,
  830.                               bgpPeerState }
  831.  
  832.  
  833.  
  834.  
  835.  
  836. Expiration Date June 1993                                      [Page 15]
  837.  
  838.                            - 16 -
  839.  
  840.  
  841.  
  842.                     DESCRIPTION
  843.                          "The BGP Established event is generated when
  844.                          the BGP FSM enters the ESTABLISHED state. "
  845.                     ::= 1
  846.  
  847.                bgpBackwardTransition TRAP-TYPE
  848.                     ENTERPRISE { bgp }
  849.                     VARIABLES  { bgpPeerRemoteAddr,
  850.                               bgpPeerLastError,
  851.                               bgpPeerState }
  852.                     DESCRIPTION
  853.                          "The BGPBackwardTransition Event is generated
  854.                          when the BGP FSM moves from a higher numbered
  855.                          state to a lower numbered state."
  856.                     ::= 2
  857.                END
  858.  
  859.  
  860. 6.  Acknowledgements
  861.  
  862.    We would like to acknowledge the assistance of all the members of the
  863.    Interconnectivity Working Group, and particularly the following
  864.    individuals:
  865.  
  866.                 Yakov Rekhter, IBM
  867.                 Rob Coltun, University of Maryland
  868.                 Guy Almes, ANS
  869.                 Jeff Honig, Cornell Theory Center
  870.                 Marshall T. Rose, PSI, Inc.
  871.                 Dennis Ferguson, ANS
  872.                 Mike Mathis, PSC
  873.                 John Krawczyk, Wellfleet Communications Inc.
  874.                 Curtis Villamizar, ANS
  875.  
  876.  
  877. 7.  References
  878.  
  879.  
  880.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  881.        Network Management Standards", RFC 1052, NRI, April 1988.
  882.  
  883.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  884.        Group", RFC 1109, NRI, August 1989.
  885.  
  886.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  887.  
  888.  
  889.  
  890.  
  891.  
  892. Expiration Date June 1993                                      [Page 16]
  893.  
  894.                            - 17 -
  895.  
  896.  
  897.  
  898.        Management Information for TCP/IP-based internets", RFC 1155,
  899.        Performance Systems International, Hughes LAN Systems, May 1990.
  900.  
  901.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  902.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  903.        LAN Systems, Performance Systems International, May 1990.
  904.  
  905.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  906.        Network Management Protocol", RFC 1157, SNMP Research,
  907.        Performance Systems International, Performance Systems
  908.        International, MIT Laboratory for Computer Science, May 1990.
  909.  
  910.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  911.        for Network Management of TCP/IP-based internets", RFC 1213,
  912.        Performance Systems International, March 1991.
  913.  
  914.    [7] Information processing systems - Open Systems Interconnection -
  915.        Specification of Abstract Syntax Notation One (ASN.1),
  916.        International Organization for Standardization, International
  917.        Standard 8824, December 1987.
  918.  
  919.    [8] Information processing systems - Open Systems Interconnection -
  920.        Specification of Basic Encoding Rules for Abstract Notation One
  921.        (ASN.1), International Organization for Standardization,
  922.        International Standard 8825, December 1987.
  923.  
  924.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  925.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  926.        March 1991.
  927.  
  928.    [10] Rose, M., Editor, "A Convention for Defining Traps for use with
  929.         the SNMP", RFC 1215, Performance Systems International, March
  930.         1991.
  931.  
  932.    [11] Rekhter, Y., and Li, T., "A Border Gateway Protocol 4 (BGP-4)",
  933.         Internet Draft, T.J. Watson Research Center, IBM Corp.,
  934.         cisco Systems, June 1992.
  935.  
  936.    [12] Rekhter, Y., and P. Gross, Editors, "Application of the Border
  937.         Gateway Protocol in the Internet", RFC 1268, T.J. Watson
  938.         Research Center, IBM Corp., ANS, October 1991.
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948. Expiration Date June 1993                                      [Page 17]
  949.  
  950.                            - 18 -
  951.  
  952.  
  953.  
  954. 8.  Security Considerations
  955.  
  956.    Security issues are not discussed in this memo.
  957.  
  958.  
  959.  
  960. Authors' Addresses
  961.  
  962.    Steven Willis
  963.    Wellfleet Communications Inc.
  964.    15 Crosby Drive
  965.    Bedford, MA 01730
  966.  
  967.    Phone: (617) 275-2400
  968.    Email: swillis@wellfleet.com
  969.  
  970.  
  971.    John Burruss
  972.    Wellfleet Communications Inc.
  973.    15 Crosby Drive
  974.    Bedford, MA 01730
  975.  
  976.    Phone: (617) 275-2400
  977.    Email: jburruss@wellfleet.com
  978.  
  979.  
  980.    John Chu
  981.    IBM Corp.
  982.    P.O.Box 218
  983.    Yorktown Heights, NY 10598
  984.  
  985.    Phone: (914) 945-3156
  986.    Email: jychu@watson.ibm.com
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004. Expiration Date June 1993                                      [Page 18]
  1005.  
  1006.